Namespaces
Variants

std::literals::string_literals:: operator""s

From cppreference.net
std::basic_string
Definiert im Header <string>
std:: string operator "" s ( const char * str, std:: size_t len ) ;
(1) (seit C++14)
(constexpr seit C++20)
constexpr std:: u8string operator "" s ( const char8_t * str,
std:: size_t len ) ;
(2) (seit C++20)
std:: u16string operator "" s ( const char16_t * str, std:: size_t len ) ;
(3) (seit C++14)
(constexpr seit C++20)
std:: u32string operator "" s ( const char32_t * str, std:: size_t len ) ;
(4) (seit C++14)
(constexpr seit C++20)
std:: wstring operator "" s ( const wchar_t * str, std:: size_t len ) ;
(5) (seit C++14)
(constexpr seit C++20)

Bildet ein String-Literal des gewünschten Typs.

1) Gibt std:: string { str, len } zurück.
2) Gibt std:: u8string { str, len } zurück.
3) Gibt std:: u16string { str, len } zurück.
4) Gibt std:: u32string { str, len } zurück.
5) Gibt std:: wstring { str, len } zurück.

Inhaltsverzeichnis

Parameter

str - Zeiger auf den Anfang des rohen Zeichenarray-Literals
len - Länge des rohen Zeichenarray-Literals

Rückgabewert

Der String-Literal.

Hinweise

Diese Operatoren sind im Namensraum std :: literals :: string_literals deklariert, wobei sowohl literals als auch string_literals inline-Namespaces sind. Der Zugriff auf diese Operatoren kann mit einer der folgenden using -Direktiven erfolgen:

  • using namespace std :: literals
  • using namespace std :: string_literals
  • using namespace std :: literals :: string_literals

std::chrono::duration definiert ebenfalls operator""s zur Darstellung von Literal-Sekunden, handelt sich jedoch um einen arithmetischen Literal: 10.0s und 10s bedeuten zehn Sekunden, aber "10" s ist ein String.

Feature-Test Makro Wert Std Funktion
__cpp_lib_string_udls 201304L (C++14) Benutzerdefinierte Literale für String-Typen

Beispiel

#include <iostream>
#include <string>
void print_with_zeros(const auto note, const std::string& s)
{
    std::cout << note;
    for (const char c : s)
        c ? std::cout << c : std::cout << "₀";
    std::cout << " (size = " << s.size() << ")\n";
}
int main()
{
    using namespace std::string_literals;
    std::string s1 = "abc\0\0def";
    std::string s2 = "abc\0\0def"s;
    print_with_zeros("s1: ", s1);
    print_with_zeros("s2: ", s2);
    std::cout << "abcdef"s.substr(1,4) << '\n';
}

Ausgabe:

s1: abc (size = 3)
s2: abc₀₀def (size = 8)
bcde

Siehe auch

konstruiert einen basic_string
(öffentliche Elementfunktion)
erstellt einen String-View eines Zeichenarray-Literals
(Funktion)